home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / vc152.zip / MANUAL.DOC < prev    next >
Text File  |  1992-06-16  |  37KB  |  970 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                                    Visual Compare
  16.  
  17.                                     Version 1.52
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.                      A file comparison utility for programmers.
  49.  
  50.  
  51.         Copyright Notice
  52.  
  53.         Copyright (C) John R. Whitney 1991, 1992
  54.         All rights reserved.
  55.  
  56.  
  57.         Trademarks
  58.  
  59.         CompuServe is a registered trademark of CompuServe, Inc.
  60.  
  61.         IBM is a registered trademark of International Business Machines
  62.         Corporation.
  63.  
  64.         Lotus is a registered trademark of Lotus Development Corporation.
  65.  
  66.         Intel is a registered trademark of Intel Corporation.
  67.  
  68.         Microsoft is a registered trademark of Microsoft Corporation.
  69.  
  70.  
  71.         Disclaimer and Agreement
  72.  
  73.         Visual Compare is supplied as is, without any warranty.  To the
  74.         extent permitted under applicable law, Whitney Software, Inc.
  75.         disclaims all warranties, either express or implied, including but
  76.         not limited to implied warranties of merchantability and fitness for
  77.         a particular purpose.
  78.  
  79.         In no event shall Whitney Software, Inc. be liable for any damages
  80.         whatsoever (including, without limitation, damages for loss of
  81.         business profits, business interruption, loss of business
  82.         information, or other pecuniary loss) arising out of the use of or
  83.         inability to use this Whitney Software, Inc. product, even if Whitney
  84.         Software, Inc. has been advised of the possibility of such damages.
  85.         Some states do not allow the exclusion of liability for consequential
  86.         or incidental damages, so the above limitation may not apply to you.
  87.  
  88.         Visual Compare is a "shareware program" and is provided at no charge
  89.         to the user for evaluation.  Feel free to share it with your friends,
  90.         but you may not give it away altered or as part of another system.
  91.         The essence of "user-supported" software is to provide personal
  92.         computer users with quality software without high prices, and yet to
  93.         provide incentive for programmers to continue to develop new
  94.         products.  If you find this program useful and find that you are
  95.         using Visual Compare and continue to use Visual Compare after a
  96.         reasonable trial period, you must make a registration payment of $30
  97.         to Whitney Software, Inc.  The $30 registration fee will license one
  98.         copy for use on any one computer at any one time.  You must treat
  99.         this software just like a book.  An example is that this software may
  100.         be used by any number of people and may be freely moved from one
  101.         computer location to another, so long as there is no possibility of
  102.         it being used at one location while it's being used at another.  Just
  103.         as a book cannot be read by two different people at the same time.
  104.  
  105.         Commercial users of Visual Compare must register and pay for their
  106.         copies of Visual Compare within 30 days of first use or their license
  107.         is withdrawn.  See the file LICENSE.DOC for a site-license agreement.
  108.  
  109.         Anyone distributing Visual Compare for any kind of remuneration must
  110.         first contact Whitney Software, Inc. for authorization.  This
  111.         authorization will be automatically granted to distributors
  112.         recognized by the Association of Shareware Professionals as adhering
  113.         to its guidelines for shareware distributors, and such distributors
  114.         may begin offering Visual Compare immediately, however Whitney
  115.         Software, Inc. must still be advised so that the distributor can be
  116.         kept up-to-date with the latest version of Visual Compare.  A
  117.         distribution fee for distributing Visual Compare may not exceed $10.
  118.  
  119.         You are encouraged to pass a copy of Visual Compare along to your
  120.         friends for evaluation.  Please encourage them to register their copy
  121.         if they find that they can use it.  All registered users will receive
  122.         a copy of the latest version of Visual Compare and notice of updates
  123.         to Visual Compare.
  124.  
  125.  
  126.         Technical Support
  127.  
  128.         If you have any questions, comments, or suggestions regarding Visual
  129.         Compare, please send a CompuServe message via CompuServe MAIL to
  130.         70661,3463 or write:
  131.  
  132.         Whitney Software, Inc.
  133.         P.O. Box 4999
  134.         Walnut Creek, CA 94596 USA
  135.  
  136.                 _______
  137.            ____|__     |               (R)
  138.         --|       |    |-------------------
  139.           |   ____|__  |  Association of
  140.           |  |       |_|  Shareware
  141.           |__|   o   |    Professionals
  142.         -----|   |   |---------------------
  143.              |___|___|    MEMBER
  144.  
  145.  
  146.         ASP Ombudsman Statement
  147.  
  148.         This program is produced by a member of the Association of Shareware
  149.         Professionals (ASP).  ASP wants to make sure that the shareware
  150.         principle works for you.  If you are unable to resolve a
  151.         shareware-related problem with an ASP member by contacting the member
  152.         directly, ASP may be able to help.  The ASP Ombudsman can help you
  153.         resolve a dispute or problem with an ASP member, but does not provide
  154.         technical support for members' products.
  155.  
  156.         Please write to the ASP Ombudsman at:
  157.  
  158.         ASP Ombudsman
  159.         545 Grover Road
  160.         Muskegon, MI 49442-9427 USA
  161.  
  162.         or send a CompuServe message via CompuServe MAIL to ASP Ombudsman
  163.         70007,3536.
  164.  
  165.  
  166.         Table of Contents
  167.         _____________________________________________________________________
  168.  
  169.  
  170.         Introduction ...................................................... 1
  171.  
  172.         Starting Visual Compare ........................................... 2
  173.  
  174.         Visual Mode ...................................................... 14
  175.  
  176.         Miscellaneous Notes .............................................. 15
  177.  
  178.         Version History .................................................. 16
  179.  
  180.  
  181.         Introduction                                                        1
  182.         _____________________________________________________________________
  183.  
  184.  
  185.         This manual describes how to use the Visual Compare program to
  186.         compare two program source files.  This manual and the Visual Compare
  187.         program were written for programmers.
  188.  
  189.         Using Visual Compare's visual mode you can easily see the differences
  190.         between two program source files and you can also selectively discard
  191.         differences in order to quickly undo some of the changes that were
  192.         made.
  193.  
  194.         Visual Compare requires an IBM Personal Computer or 100% compatible
  195.         running DOS version 2.1 or later.
  196.  
  197.         Visual Compare uses a comparison algorithm that has been
  198.         mathematically proven to always produce a shortest possible sequence
  199.         of insertions and deletions that will convert file one to file two.
  200.  
  201.  
  202.         Starting Visual Compare                                             2
  203.         _____________________________________________________________________
  204.  
  205.  
  206.         There are two ways to control the start of Visual Compare:
  207.  
  208.         1. Through arguments specified on the Visual Compare command line.
  209.  
  210.         2. Through commands specified in the Visual Compare initialization
  211.            file.
  212.  
  213.  
  214.         Visual Compare Command Line
  215.  
  216.         Run Visual Compare with no arguments to see a list of the available
  217.         command line arguments or to have Visual Compare prompt for
  218.         arguments.
  219.  
  220.         The form of the Visual Compare command line is as follows:
  221.  
  222.              VCOMP fileone filetwo [options]
  223.  
  224.  
  225.         VCOMP
  226.  
  227.         The name of the program module.
  228.  
  229.  
  230.         fileone
  231.  
  232.         The first of two files you wish to compare.
  233.  
  234.  
  235.         filetwo
  236.  
  237.         The second of two files you wish to compare.
  238.  
  239.  
  240.         If fileone or filetwo ends with a backslash (\) or colon (:) symbol,
  241.         the filename (file name and optional extension) from th